home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 4 / Amiga Tools 4.iso / tools / packer / unzip512x / readme < prev    next >
Encoding:
Text File  |  1996-02-26  |  8.9 KB  |  172 lines
  1. This is the README file for the 28 August 1994 public release of the
  2. Info-ZIP group's portable UnZip zipfile-extraction program (and related
  3. utilities).
  4.  
  5. unzip512.zip    portable UnZip, version 5.12, source code distribution
  6. unzip512.tar.Z    same as above, but compress'd tar format
  7.  
  8. __________________________________________________________________________
  9.  
  10. BEFORE YOU ASK:  UnZip, its companion utility Zip, and related utilities
  11. and support files can be found in many places; read the file "Where" for
  12. further details.  To contact the authors with suggestions, bug reports,
  13. or fixes, continue reading this file (README) and, if this is part of a
  14. source distribution, the file "ZipPorts".  Also in source distributions:
  15. read "BUGS" for a list of known bugs, non-bugs and possible future bugs;
  16. INSTALL for instructions on how to build UnZip; and "Contents" for a com-
  17. mented listing of all the distributed files.
  18.  
  19. ALSO NOTE:  Info-ZIP's mailing addresses changed between UnZip 5.0p1 and
  20. 5.1 releases (and since Zip 2.0.1)!  The old BITNET address doesn't even
  21. exist anymore.  See below.
  22. __________________________________________________________________________
  23.  
  24.  
  25. GENERAL INFO
  26. ------------
  27. UnZip is an extraction utility for archives compressed in .zip format (also
  28. called "zipfiles").  Although highly compatible both with PKWARE's PKZIP 
  29. and PKUNZIP utilities for MS-DOS and with Info-ZIP's own Zip program, our
  30. primary objectives have been portability and non-MSDOS functionality.
  31.  
  32. This version of UnZip has been ported to a wide array of hardware--from 
  33. micros to supercomputers--and operating systems:  Unix (many flavors),
  34. VMS, OS/2, MSDOS (+ Windows), NT, TOPS-20 (partly), AmigaDOS, Atari TOS,
  35. Macintosh and Human68k.  UnZip features not found in PKUNZIP include source
  36. code; default extraction of directory trees (with a switch to defeat this, 
  37. rather than the reverse); VMS, Macintosh and OS/2 extended file attributes; 
  38. and, of course, the ability to run under most of your favorite operating 
  39. systems.  Plus, it's free. :-)
  40.  
  41. For source distributions, see the main Contents file for a list of what's
  42. included, and read INSTALL for instructions on compiling (including OS-
  43. specific comments).  The individual operating systems' Contents files (for 
  44. example, vms/Contents) may list important compilation info in addition to 
  45. explaining what files are what, so be sure to read them.  Some of the ports 
  46. have their own, special README files, so be sure to look for those, too.
  47.  
  48. See unzip.1 or unzip.doc for usage (or the corresponding UnZipSFX, ZipInfo
  49. and fUnZip docs).  For VMS, unzip_def.rnh or unzip_cli.help may be compiled
  50. into unzip.hlp and installed as a normal VMS help entry; see vms/descrip.mms.
  51.  
  52.  
  53. CHANGES AND NEW FEATURES
  54. ------------------------
  55. The 5.12 release mainly fixes some bugs in 5.11, including a silly pointer
  56. error in unzipsfx.  The only new features are fairly minor:
  57.  
  58.    - ZipInfo check for dead space inside archives (PKZIP/Netware bug)
  59.    - SFX_EXDIR compilation option to allow -d <exdir> with UnZipSFX
  60.    - "unzip -vqqqq" prints just the version number (e.g., "512")
  61.  
  62. Since neither 5.11 nor 5.1 was posted to Usenet, here's a summary of their
  63. new features.  In UnZip 5.11:
  64.  
  65.    - UnZipSFX, a self-extraction stub for prepending to (new-style) zipfiles
  66.       (tested under Unix, VMS, MS-DOS, OS/2, etc.; NOT portable *across* OSes)
  67.    - unshrink() rewritten to avoid copyright problems; 32-bit version only
  68.    - strings moved to far memory in MS-DOS:  can use small model again (MSC)
  69.    - numerous customization options (see INSTALL)
  70.    - diagnostic screen with -v option and no zipfile (i.e., "unzip -v")
  71.    - -C option for case-insensitive filename matching (esp. for MS-DOS, OS/2)
  72.    - more bad-zipfile "intelligence" (can sometimes even extract concatenated
  73.       multi-part archives)
  74.    - former -U behavior is now the default; new -L option to provide what was
  75.       the default behavior (auto-conversion of uppercase-OS filenames to lower
  76.       case)
  77.    - ZipInfo -T option to print times in decimal format (yymmdd.hhmmss) for
  78.       piping into sort(1)
  79.    - performance tweaks for listing archive contents
  80.    - improved/expanded documentation, esp. man pages (*.doc files) and INSTALL
  81.  
  82. In UnZip 5.1:
  83.  
  84.    - wildcard zipfiles (e.g., "unzip -tq \*.zip")
  85.    - extract to a directory other than the current one (-d <exdir> option)
  86.    - auto-conversion of text files
  87.    - ANSI sequences disabled in comments and filenames (avoid "ANSI bombs")
  88.    - ZipInfo incorporated into UnZip (-Z option)
  89.    - full Amiga, Atari, Mac, NT and Human68K support (partial TOPS-20)
  90.    - performance tuning for 35-70% faster extraction (depends on compression
  91.       method)
  92.  
  93. Note that, according to one tester, the 32-bit MS-DOS version is now *faster*
  94. than PKUNZIP on most archives!  Cool.
  95.  
  96.  
  97. DISTRIBUTION
  98. ------------
  99. If you have a question regarding redistribution of Info-ZIP software,
  100. either as-is, as packaging for a commercial product, or as an integral
  101. part of a commercial product, read the Frequently Asked Questions (FAQ)
  102. section of the included COPYING file.
  103.  
  104. Insofar as C compilers are rare on some platforms and the authors only
  105. have direct access to Unix, VMS, OS/2, MS-DOS, Mac, Amiga and Atari 
  106. systems, others may wish to provide ready-to-run executables for new
  107. systems.  In general there is no problem with this; we require only that 
  108. such distributions include this README file, the Where file, the COPYING 
  109. file (contains copyright/redistribution information), and the appropriate 
  110. documentation files (unzip.doc and/or unzip.1 for UnZip, etc.).  If the 
  111. local system provides a way to make self-extracting archives in which both 
  112. the executables and text files may be stored together, that is best (in
  113. particular, use UnZipSFX if at all possible, even if it's a few kilobytes
  114. bigger than the alternatives); otherwise we suggest a bare UnZip executable
  115. and a separate zipfile containing the remaining text and binary files.  If
  116. another archiving method is in common use on the target system (for example,
  117. Zoo or LHa), that may also be used.
  118.  
  119.  
  120. BUGS AND NEW PORTS:  CONTACTING INFO-ZIP
  121. ----------------------------------------
  122. All bug reports and patches (context diffs only, please!) should go to 
  123. zip-bugs@wkuvx1.wku.edu, which is the e-mail address for the Info-ZIP
  124. authors.  "Dumb questions" which aren't adequately answered in the docu-
  125. mentation should also be directed here rather than to a global forum such
  126. as Usenet.  (Kindly make certain that your questions *isn't* answered by
  127. the documentation, however--a great deal of effort has gone into making
  128. it clear and complete.)  Suggestions for new features can be sent to
  129. info-zip@wkuvx1.wku.edu, a mailing list for the Info-ZIP beta testers, 
  130. for discussion (the authors hang out here as well, of course), although 
  131. we don't promise to act on all suggestions.  If it is something which is 
  132. manifestly useful, sending the required patches to zip-bugs directly (as
  133. per the instructions in the ZipPorts file) is likely to produce a quicker 
  134. response than asking us to do it--the authors are always somewhat short 
  135. on time.  (Please do NOT send patches or encoded zipfiles to the info-zip 
  136. address.)
  137.  
  138. If you are considering a port, not only should you read the ZipPorts file,
  139. but also please check in with zip-bugs BEFORE getting started, since the 
  140. code is constantly being updated behind the scenes.  For example, an Acorn/
  141. Archimedes port is already almost complete, as is an OS/2 dynamic link lib-
  142. rary (DLL) version; VMOS, VM/CMS, Netware, QDOS and NT DLL ports are claimed
  143. to be under construction, although we have yet to see any up-to-date patches.
  144. We will arrange to send you the latest sources.  The alternative is the pos-
  145. sibility that your hard work will be tucked away in a sub-archive and mostly
  146. ignored, or completely ignored if someone else has already done the port
  147. (and you'd be surprised how often this has happened).  IBM mainframe ports
  148. (VM/CMS and/or MVS) would be particularly welcome.  (It can't be *that* hard,
  149. folks...the VMS filesystem is similar in many ways.)
  150.  
  151.  
  152. BETA TESTING:  JOINING INFO-ZIP
  153. -------------------------------
  154. If you'd like to keep up to date with our UnZip (and companion Zip utility)
  155. development, join the ranks of beta testers, add your own thoughts and con-
  156. tributions, etc., send a two-line mail message containing the commands HELP
  157. and LIST (on separate lines in the body of the message, not on the subject
  158. line) to mxserver@wkuvx1.wku.edu.  You'll receive two messages listing the 
  159. various Info-ZIP mailing-list formats which are available (and also various
  160. unrelated lists) and instructions on how to subscribe to one or more of them
  161. (courtesy of Hunter Goatley).  As of mid-1994, subscribing to the announce-
  162. ments list requires a command of the form
  163.  
  164.     SUBSCRIBE Info-ZIP-announce "Joe Isuzu"
  165.  
  166. The discussion list is called either Info-ZIP or Info-ZIP-digest, depending
  167. on one's preference for delivery.
  168.  
  169.  
  170. -- Greg Roelofs (Cave Newt), UnZip maintainer/container/explainer and
  171.    developer guy, with inspiration from David Kirschbaum
  172.